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SECTION 1 
DESCRIPTION 



The Hewlett-Packard 91731A Asynchronous Multiplexer Subsystem is one 
of the software drivers for the HP Real-Time Executive (RTE) Operating 
System. The Subsystem provides simultaneous communication with up to 

sixteen asynchronous bit-serial devices through the HP 12920B 
Asynchronous Multiplexer. The peripheral devices can be either 
hardwired to the Multiplexer or connected through full-duplex modems. 



A multiplexer allows siqnals from several lines to be channeled 
through a single port. In this case, the single port is in the I/O 
system of an HP 1000 Computer System, and the multiple lines are 
communication lines between the System and terminals or other devices. 

There are many types of multiplexers; for simplicity, consider the 
Asynchronous Multiplexer to be like sixteen buffered Teletype 
interfaces. There are differences between the simple Teletype 
interface and the Multiplexer, but the mode of communication is the 
same: asynchronous bit serial. 



Asynchronous bit-serial devices, numbering in the hundreds, comprise 
such devices as keyboards, displays, hardcopy terminals, printers, and 
tape cassette drives. The Multiplexer Subsystem specifically supports 
certain Hewlett-Packard terminals, including the Cartridge Tape Units 
and Block Mode on the supported terminals that have those features. 
The Subsystem also supports an Auxiliary Printer connected to a 
terminal . 



SUBSYSTEM AND MULTIPLEXER 



The HP 91731A Asynchronous Multiplexer Subsystem contains the software 
that an PTE Operating System uses to communicate with I/O devices 
through the HP 12920 Multiplexer. The Multiplexer is the interface 
hardware that physically connects 16 RS-232 iines to three I/O slots 
in an HP 1000 Computer System. The Multiplexer Subsystem supports one 
or two Multiplexers, interfacing up to 32 lines. 
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-SUBSYSTEM AND MULTIPLFXER- 



HP 91731A ASYNCHRONOUS MULTIPLEXER SUBSYSTEM 



The Multiplexer Subsystem consists of one Physical Driver, one Logical 
Driver, and the Manuals in the following list: 



For one 
Phy 
Log 



For two 
Phy 
Log 



Source : 
Phy 
Loq 



Manuals : 
HP 
HP 
HP 



HP 12920F: 
sical Driver DVSOO 
ical Driver LDVR5 
Block Mode 

Block Mode and Cassettes 

HP 12920B: 
sical Driver DVSOO 
ical Driver LDVP5 
Block Mode 

Block Mode and Cassettes 

sical Driver DVSOO 
ical Driver LDVR5 

For one HP 12920B 

For two HP 12920B 

91731A User 's Guide 

91731A Software Numbering Catalog 

91731A Configuration Guide 



Name 


Part Number 


%DVS0N 


91731-16001 


%LD5AN 
%LD5AZ 


91731-16002 
91731-16003 


%DVS0Z 


91731-16004 


%LD5BN 
%LD5BZ 


91731-16005 
91731-16006 


&DVS00 


91731-18001 


&LDV5A 
&LDV5B 


91731-18002 
91731-18003 

91731-90001 
91731-90002 
91731-90003 



HP 12920B ASYNCHRONOUS MULTIPLEXER 



The HP 12920B Asynchronous Multiplexer consists of three I/O cards, a 
connector panel for RS-232 connectors, and interconnecting cables. 



The Multiplexer has two data boards, Upper Data PCA (12920-60001) and 
Lower Data PCA (12920-60002) which multiplex the 16 input data lines 
into one data path and demultiplex one output data path into 16 data 
lines. There is a Control Board (12922-60001) which sends and receives 
the line control signals for the 16 terminals or modems that are 
connected to the Multiplexer. 



A Connector Panel (30062-60017) provides the 16 RS-232 connectors and 
five connectors to connect the terminals and modems to the control and 
data boards. Only three control connectors are used in the 
configuration supported by the HP 91731A Subsystem. 



A Data Cable (12921-60003), Control Cable (12922-60003), and a Test 
Cable (30062-60003) complete the HP 12920B Multiplexer hardware 
supported by the HP 91731A Asynchronous Multiplexer Subsystem. 
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LOGICAL AND PHYSICAL DPIVEPS 



PTE drivers usually control only one type of device each. The 
Multiplexer, however, can control many types of devices through one 
I/O port if all the devices are PS-232 compatible. 



A single driver capable of handlina all these devices would be large 
and complex, because, while all the devices may be RS-232 compatible 
and work through similar modems, they may haye many different control 
sequences and line protocols to handle different functions, such as 
controlling auxiliary printers or cartridge tape units. 



To simplify the driver and to regulate the size according to the 
application, the HP 91731A consists of a logical driver and a physical 
driver . 



The logical driver handles the device dependent functions such as 
communications protocol, special codes the device understands, and 
special characters the device sends. 



The physical driver handles the device-independent RS-232 functions 
that are common to all devices. These functions include the line data 
rate, character format, number of start/stop bits, and modem 
connect/disconnect. The physical driver also remembers which 
Multiplexer port requires which type of logical driver. 



The logical driver is attached to the physical driver by passing the 
entry point address of the logical driver and LU number of the 
Multiplexer port to the physical driver. 



PHYSICAL DRIVER DVSOO 



DVSOO is the physical driver portion 
also contains a default Teletype (TTY) 
another logical driver is not attached 
user . 



of the HP 91731A Subsystem. It 
logical driver that is used if 

to the physical driver by the 



The default TTY driver supports character mode operation and provides 
a set of default conditions to allow for ease of use and operation. 
You can change any or all of the default conditions by using control 
requests described in Section 2 of this manual. 
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-LOGICAL AND PHYSICAL DFIVERS- 



The default TTY driver that is contained in DVSOO is primarily 
designed to communicate with a simple terminal similar in features and 
interface characteristics to a teletype. When the default TTY driver 
is in use, the characters are input and output in standard 8-bit 
ASCII. 



Some special character processing on input allows the use of carriage 
return/line feed (CP/LF) as a record separator, CNTL-D as an End Of 
Tape, deleting characters in the users buffer on backspace, canceling 
an entry on a rub-out, and interpretation of CNTL-A, CNTL-H, and 
CNTL-Y as backspace. 

On output, the use of left arrow (underline, octal 137) to suppress CF 
LF and the ability to strike any key to interrupt output are 
supported. Also, striking any key will schedule a program, if 
designated during system generation. When using the default TTY 
driver, the driver type is 00, for programs that test for this 
information . 

LOGICAL DFIVEF LDVP5 



LDVR5 is a logical driver that operates with the Physical Driver in 
DVSOO. LDVP5 supports keyboard input in either character or block 
mode. Using LDVP5 with a properly equipped HP terminal, you can input 
from, output to and control Cartridge Tape Units and Auxiliary 
Printers. A Block Mode read can be initiated on a 2645A or 2648A 
terminal from a user program. When using logical driver LDVR5, the 
driver type is 05 . 
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OPERATING ENVIRONMENT 



The FP 91731A Asynchronous Multiplexer Subsystem operates in an 
HP 1000 Computer System, allowing the user to expand the system I/O 
capability beyond the unexpanded hardware limitations. One Subsystem 
connects up to 16 terminals to the Operating System, with optional 
modem links, while using only three physical select codes. Two 
Subsystems accommodate up to 32 terminals using six select codes. 



SYSTEM REQUIREMENTS 

Inclusion of the HP 91731A Multiplexer Subsystem in an HP 1000 
Computer System, places certain requirements on the system. The 
paragraphs that follow summarize hardware and software requirements. 



Hardware 



Use of the Subsystem requires that the following hardware be included 
in the HP 1000 Computer System: 



An KP 1000 M, E, or F-Series Computer. 

An HP 12920B Interface Kit consisting of two data boards, a 
control board, a connector panel, and the associated cabling. 

An HP 12539C Time Base Generator. 

An HP 12620A Breadboard Interface Kit. 



Software 



The Asynchronous Multiplexer Subsystem operates in one of the 
following operating systems: 

RTE IV (92067A) 
RTE M(III) (92064A) 
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-OPERATING ENVIPONMENT- 



However, when using the Multiplexer Subsystem in one of these 
operating systems, the following restrictions must be observed (for 
more details, see the HP 91731A Configuration Guide): 

PJE 1000 (91780A): may not be run while Subsystem is active. 

DS/1000 (91740A/B, 91741A) : Privileged data communications may 
not be used while Subsystem is active. 



HP ATS: Subsystem not compatible with HP Automatic Test System. 

DATACAP/1000 is not supported by the Multiplexer Subsystem. 

Writable Control Store (HP 12971A WCS Kit): Loading WCS Board via 
DCPC may cause incoming data to Multiplexer to be lost. 

Any HP or User code thet is privileged (non-interruptable) : 
Incoming data can be lost if a program turns off the interrupt 
system . 



DVS00 must be generated into the operating system as a privileged 
driver. It requires approximately 4000 bytes of storage plus 52 bytes 
of Equipment Table (EOT) space in the system driver area in PTE-IV for 
each port configured into the system. 

LDVP5 is also generated into the operating system; however, it resides 
in the Subsystem Global Area (SSGA) of the operating system. LDVF5 
requires approximatly 2970 bytes of storage. 



COMMUNICATION LINE ENVIRONMENT 



An important point about the Multiplexer is that it can operate 
simultaneously and independently on any mix of asynchronous 

communications lines regardless of the differences in bit rate, line 
discipline, or operating mode as long as the aggregate baud rate is 

within that supported by PTE. The thread of commonality between the 
different communication lines and devices usable by the Multiplexer is 
that data is transferred one bit at a time. 
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-OPEPATING ENVIRONMFNT- 



Bit-Serial Transirission 



In bit-serial transirission, the characters are made up of a group of 
five to eight bits. Each character is preceded by a start bit and 
followed by one or more stop bits, depending on the format. Since the 
Subsystem provides for the character size and the start and stop bit 
configuration to be programmatically set for each channel, the 
Multiplexer Subsystem can run any mix of bit-serial devices 
simultaneously. 



Selectable Transmission Speeds 



In bit-serial transmission, characters are sent in a timed sequence of 
bits. A bit is a unit of information, the term "bit" standing for 
"binary digit". Often confused with "bit" is "baud", the shortest 
duration signaling element. Generally, though, "bit" and "baud" are 
equal, and the terms car be used interchangeably. 



There are at least a dozen common speeds at which asynchronous 
bit-serial devices operate. The speed is the device bit or baud rate. 
The Asynchronous Multiplexer Subsystem will support 251 separate, 
different, transmit and receive speeds between 56 and 2400 baud for 
each channel. The Subsystem is also capable of automatically sensing 
speeds of 110, 150, 300, 600, 1200, and 2400 baud. 



Full-Duplex Operation 



Bit-serial transmission uses only a single wire and a ground return to 
transfer information. Because of the cost advantage of using a single 



wire or a pair, this 
invention of Morse code, 
three wires, one for data 

return. This three-wire 
communication equipment. 



mode of operation has been used since the 
Today's asynchronous bit-serial devices use 
out, one for data in, and one for the common 
configuration allows the use of full-duplex 



Full duplex means that two devices communicating with each other can 
be transmitting and receiving simultaneously. The data being received 
can be different from the data sent. Some applications use this 
feature to print out a different character from the one typed, or to 
separate input and output into independent information streams. 
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-OPERATING ENVIRONMENT- 



Usually, as in the case of a Teletype, the full duplex operation is 
used to echo back the character that was typed. This provides a simple 
and very effective method of error control. A bit error on the line 
echoes a character different from the one that was typed, and the 
error can be detected visually at the terminal. 



Asynchronous Transmission 



Asynchronous transmission means that the receiving and transmitting 
ends can have independent clocks to strobe the bits in or out. The 
clocks must be going at approximately the same frequency, but can 
differ by one percent before transmission failure occurs. 



Since the clocks are not in synchronization, the transmission mode is 
termed "asynchronous". In order to know when to shift a bit in, the 
receiver must be able to synchronize itself with the bit stream. It 
does this by detecting a start bit and timing itself from this 
transition to the middle of the remaining bits in the character. It 
does not matter how much time elapses between the stop bits of one 
character and the start bit of the next character, because the 
receiver always resynchronizes itself. 



TERMINALS 



Table 1-1 lists the HP terminals that are supported by the Multiplexer 
Subsystem. While terminals by other manufacturers may be compatible, 
they are not supported by Hewlett-Packard. The table shows the 
compatibility of each terminal with DVSOO and with LDVR5 in 
combination with DVSOO. 



NOTE 

If a terminal is compatible with the default TTY driver 
included in DVSOO, and that terminal has the ability to 
function in both block and character mode, then that 
terminal must be in character mode when using the default 
TTY driver. 
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-OPERATING ENVIRONMENT- 



Table 1-1. HP Terminals Supported by HP 91731A 



Terminal 


1 DVSOO Default 


LDVP5/DVS00 


Model Number 


1 TTY Driver 


Combined 



2621A/P 1 


YES #+ 1 


YES 


2631A Opt 40 I 


NO 1 


YES 


2635A 1 


NO I 


YES 


2640A/B 1 


YES + | 


YES 


2645A 1 


YES *+ 1 


YES 


2648A 1 

1 


YES *+ | 


YES 



# The auxiliary printer is not subchannel 4, 

as on 2640-series terminals; output 
directed to the printer must first be 
written to the display, then dumped to the 
pr inter. 

* DVSOO will not access a Cartridge Tape Unit 

or Auxiliary Printer. 
+ DVSOO operates in character mode only; 
block mode not supported. 



MODEMS 



At times it is necessary to communicate with a device over telephone 
lines or a radio link. In these cases, a modulator-demodulator (modem) 
pair interfaces with the multiplexer subsystem. By providinq 
important control lines and creating an interface which can be set to 
give an interrupt on rising, falling, or both edges of a status line 
signal, control and use of full-duplex modems is supported and 
maintained . 



Modems are controlled by DVSOO. Operation of LDVR5 is independent of 
modem usage. 
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-OPERATING ENVI RONMENT— 



The Multiplexer Subsystem supports a Bell tyoe 103 or 212 modem, or a 
Vadic Corporation VA3400 modem. The Bell type 103 is a full duplex, 
frequency-shift keyed, 0- to 300-baud modem. The Bell type 212 is 
similar to the 103 except that the data rate is selectable at either 
0-300, or 1200 baud. The VA3400 is similar to the 212 dataset, but 
supports 300, 600 and 1200 baud; however, it can only communicate with 
another VA3400 modem. 



Dse of these modems with the Multiplexer Subsystem is supported by 
Hewlett-Packard in the United States and Canada. In areas outside of 
the United States and Canada, check with the public telephone 
authority or independent modem supplier and the local Hewlett-Packard 
representative to determine modem compatibility with DVS00 and the 
12920B interface. 
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SECTION 2 



PROGRAMMING AND OPERATION 



Operating the Multiplexer Subsystem consists of using EXEC control 
requests or the File Manager CN command to initialize the terminals, 
then programming read and write requests to make data transfers 
through the Multiplexer. 

After initialization, you should not normally be concerned with 
whether a terminal is connected through the Multiplexer or connected 
directly to the computer. Data transfer requests are either read and 

write statements in a high-level language program, or EXEC calls from 
either an Assembly language program or a high-level language prooram. 



DPIVER RESPONSIBILITIES 



This section describes the responsibilities of the physical driver 
(DVSOQ) and the logical driver (LDVR5) . 



PHYSICAL DPIVER DVSOO 



The physical driver is responsible for the following: 

a. Controlling the HP 12920B interface boards. 

b. Making all timing reouests, both for itself and for the 
logical driver. 

c. Detecting line errors, parity errors, and break conditions. 

d. Calling the logical driver whenever the physical driver: 

Gets a new I/O request, 
Receives a character, 
Sends a character, 
Detects a line error, or 

Senses a time-out of interest to the logical driver. 

e. Deciding when an I/O request is complete, or if a control 
request is to be handled by the logical driver. 
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-DPIVEP FESPONSIBILITIFS*- 



f. Maintaining a status indication in EOT word 5 ( EQT5) • the EQT 
status conditions are: 



LOGICAL DPIVEP LDVF5 



LDVP5 is a logical driver specifically designed to provide special 
functions for terminals connected to the Multiplexer. These functions 
include Block Mode operation and CTU or Auxiliary Printer utilization. 
Logical drivers in general are responsible for the following: 

a. Handling communication processing that is not completely 
general. 

b. Deciding when an I/O request is complete Exception: certain 
control requests) . 

c. Maintaining the transmission log of the number of characters 
or words sent or received by a write or read reouest. 

d. Detecting errors that are defined as errors by the logical 
driver, such as the violation of message syntax. The errors 
reported to the logical driver by the physical driver are 
taken into consideration but are handled as the logical 
driver dictates. For example, it might take "n" physical 

errors of a certain kind to result in one logical error. 

e. Packing and storing of characters on read; unpackina 
characters on write. 



Bits 



Meaning 



7 
6 
5 
4 
3 
2 
1 
0 



Buffer Flush 

BPEAF key hit (write only) 
End-Of-Tape status 
Time-Out 

Speed Sense Mode - in progress 
Bad Comm Line 

Pause Mode luser interrupted output) 
Terminal Enabled (1) , Disabled (0) 
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REQUEST FORMAT 



Input, output, and control reauests to the HP 91731A Multiplexer 
Subsystem are generally in the form of RTE EXEC calls. EXEC can be 
called from Assembly language programs or from high-level language 
programs . 



The input request is a "read" request. The output request is a "write" 
reouest. Pead and write reauests use EXEC calls, while control 
requests can be initiated either by using the EXEC call, or by using 
the File Manager CN command. 



EXEC CALLING SFQUENCES 



This section contains general instructions for calling EXFC from PTE 
Assembly language programs and from RTE FOPTRAN IV programs. For other 
high-level languages, refer to the PTE Programmer's Reference Manual 
for your PTE Operating system and to the appropriate language 
reference manual. Pefer to this manual for the specific parameter 
uses. 



In the following examples, the only names that must be used as given 
are EXEC and ABREG. Other names, such as ICODE, ICNWD, and IPRl, are 

simply mnemonics used in this manual and in other PTE manuals to 
identify the parameters of the calls. For these mnemonics, you can use 
any names that suit your purpose. 
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-REQUEST FOEWT- 



Calling EXEC froir. Assembly Language 



The Assembly language calling sequence for EXEC calls is as follows 



EXT EXEC Declare EXEC as an external 



RTN 



JSB EXEC 
DEF PTN 
DEF ICODE 
DEF ICNWD 
DEF IPP1 
DFF TPF2 
Return Point 



Transfer control to PTE 
Return address 
Request code 
Control word 
Parameter 1, optional 
Parameter 2, optional 



ICCDE DEC n 
ICNWD OCT cnwd 



IPR1 
IPP2 



OCT prl 
OCT pr2 



n = 1 for read, 2 for write, 3 for control 
Value depends on function; the lower 

six bits always contain the LU number 

assigned to the port 
Use depends on 

type of call 



On return the A- and B-Pegisters can be examined for various functions 
depending on the type of call. 



The return point, labeled PTO, must follow the DEF to the last 
parameter used. EXEC uses this address to calculate the number of 
parameters passed for those calls that have optional parameters. 
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-REQUEST FORMAT- 



Calling EXEC from PTE FORTRAN IV 

To call EXEC as a subroutine from PTE FORTRAN IV, use the following 
calling sequence: 



I CODE 
ICNWD 
IPP1 
IPR2 



n 

cnwd 

prl 

pr2 



CALL EXEC (ICODE, ICNWD, IPRl,IPR2) 
CALL ABREG (IA , IB.) 



EXEC can also be called as a function from PTE FORTRAN IV, using the 
following calling sequence: 



DIMENSION IREG(2) 

EQUIVALENCE (REG , IPEG) , ( IA , IREG) , (IB,IPEG(2) ) 



PEG = EXEC (I CODE , ICNWD , IPPl , I PR 2) 



The values of ICODE, 
Assembly language call. 



ICNWD, IPPl, and IPR2 are as defined for the 



The two different methods of calling EXEC from FORTRAN illustrate the 
two ways of getting the A- and B-Pegister returns from the EXEC call. 
In either case, IA and IB will contain the values returned in the A— 
and E-Pegisters respectively. Consult the following sections for the 
meanings of these returned values for each individual call. 



In the following sections the examples used to illustrate the calls 
are written using the REG = EXEC ( . . . method. This method can be used 
to make read, write, and control requests. For each control request, 
there is also an example showing how to make the call from the File 
Manager, using the CN command. 
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-REQUEST FORMAT- 



EXEC CALL PARAMETERS 



Request code ICODE and control word ICNWD, in that order, are the 
first two parameters of the EXEC call. Other parameters, when needed, 
are described for each request in the following sections. 



Request Code ICODE 



Parameter ICODE identifies the type of request. There are four types 
described in this manual: 



ICODE= 1 
ICODE= 2 
ICODE= 3 
ICODE= 13 



Read request 
Write reauest 
Control request 
I/O Status request 



Control Word ICNWD 



Control word ICNWD contains a function code and the logical unit 
number (LU) of the device to which the request is directed. Structure 
the control word as follows: 



15 10 6 5 0 

+ — +--+. — +--+ — + — + — + — + — + — + — +--+ — 

lOOOOOlFFFFFlLLL LLLI 
+-_+__+_..+_-+_,- + — +„_+_.. +. — +. — +__+__+__+ — +--+ 

|<— function— > I <— logical unit-> I 

code number 



For example, if the function code is octal 5 and the LU number is 
decimal 10, the value of ICNWD can be programmed: 

ICNWD = 10 + 500B 
where the B suffix identifies "500" as an octal number. 
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Function Code 



The octal value of the required function code is given for each of the 
request descriptions in the following sections. Use whatever method 
you prefer to place the value in bits 10 through 6 of control word 
ICNWD. For example, if the value is octal 5, add 500B to the value of 
the LU number, as illustrated in the previous paragraph. ICNWD = LU 
when the function code is zero. 



Logical Unit Number LU 



The logical unit number is the system address for the I/O device to 
which you are directing the request. Your system aeneration listing 
lists the LU numbers of all I/O devices integrated into the system. In 
the case of the Multiplexer Subsystem, each LU number corresponds to a 
Multiplexer port. 
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CONTROL REQUESTS 



Control requests have the following general format: 
REG = EXEC (ICODE,ICNWD, IPRl) 

When issuing a control command from the File Manager the following 
format is used: 

:CN ,lu[ , fn[,pr] ] 

lu = LU number 

fn = function code 

pr = optional parameter 

For example, to find file 19 on a CTU assigned to LU 23: 

:CN,23,27B,19 



PARAMETERS 



Request code ICODE has a value of 3 for all control reouests. Each 
control request has a different function code in ICNWD, and the value 
of parameter IPRl depends on the function code. Table 2-1 is a summary 
of the function codes and their meanings, their availability with 
LDVR5 and DVSOO, and the applicability of optional parameter IPRl. 



RETURNS 

In the Equipment Table (EQT) , word five (EQT5) is the status word. On 
return from a control request, the A-Register contains the device 
status from EQT5, if the EOT is unbuffered. If the EOT is buffered, 
the A-Register is meaningless. In both cases the B-Register is 
meaningless. 



2-8 Change 1 



-CONTROL REQUESTS- 
Table 2-1. Control Request Function Codes and Parameters 



Code 


1 Description 


1 LDVR5 


DVS00 


IPP1 


01 


1 Write end-of-file (FOF) to CTU 


1 Yes 


No 


NO 


02 


1 Backspace one record on CTU 


1 Yes 


No 


NO 


03 


1 Forward space one record on CTU 


1 Yes 


1 NO 


NO 


04 


I Rewind CTU 


1 Yes 


NO 


No 


05 


1 Set receive speed parameter 


1 Yes 


Yes 


Yes 


07 


1 Set end-of-tape status 


1 Yes 


Yes 


No 


10 


1 Write ECF if not just previously written 


1 Yes 


NO 


No 


11 


1 Space printer or CRT 


1 Yes 


No 


Yes 


12 


I Set CP/LF delay 


1 No 


Yes 


Yes 


13 


1 Forward space one file on CTU 


1 Yes 


NO 


NO 


14 


! Backspace one file on CTU 


1 Yes 


NO 


NO 


16 


1 Set send speed parameter 


1 Yes 


Yes 


Yes 


17 


! Set speed sense mode 


1 Yes 


Yes 


Yes 


20 


1 Enable terminal 


1 Yes 


Yes 


Yes 


21 


Disable terminal 


1 Yes 


Yes 


NO 


22 


Set time-out 


1 Yes 


No 


Yes 


23 


Flush buffer 


1 Yes 


Yes 


No 


24 


Unflush buffer, restore output processing 


! Yes 


Yes 


NO 


25 


.Attach logical driver 


1 Yes 


Yes 


Yes 


26 


Write end-of-data (FDD) to CTU 


1 Yes 


NO 


No 


27 


Locate absolute file on CTU 


1 Yes 


NO | 


Yes 


30 


Close line for modem 


1 Yes 


Yes 


NO 


31 


Open line for mcdem 


1 Yes 


Yes 


Yes 


32 


Update Terminal Status 


I Yes 


No | 


NO 
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INITIALIZATION CONTROL REQUESTS 



Port initialization consists of a sequence of control calls that first 
set up conditions for the physical driver and then issue an Enable 
Terminal request. Conditions that are to be the same as the 
corresponding default condition need not be specified at 
initialization time. Conditions that are to be different from the 
default condition "must be set using individual control calls. 



The default conditions are: 



Baud rate: 
CE/LF Delay: 
Hardwired Terminal: 
Logical Driver: 
Character size: 
Parity: 

Backspace Mode: 
Time-out Action: 
Echo : 



110 for transmit and receive 
None 

Modems not in use 
Default TTY Driver 
8 bits 
None 

Echo underscore on backspace 

Down device 

On 



The conditions to be set up individually are the transmit and receive 
baud rates, CR/LF delay, and modem usage. Also, if desired, a logical 
driver can be attached to the physical driver at initialization time. 
Conditions that are included in the Enable Terminal request are 
character size, parity, backspace mode, time-out action, and echo. 



Note that the default conditions are valid only at boot-up. Once a 
condition has been changed, the new value becomes the default value 
until the system is rebooted. 



BAUD RATE SPECIFICATION 



The Multiplexer transmit and receive baud rates are derived from a 
numerical rate parameter (I p P) specified by the user. The formula for 
calculating the actual baud rate from this rate parameter is as 
follows : 

BAUD = 14400. /(IRP+1) 

where: 0 <= IRP <= 255 
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There are 256 discrete baud rates available. IPP = 0 is 14400 baud and 
IFP = 255 (377 octal) is 56.25 baud. However, the maximum baud rate 
that is physically reachable by the multiplexer hardware is 2400 baud 
on any one terminal. Not all of the remaining 251 baud rates available 
are integer baud rates. But, since this is an asynchronous 
communication link, a one per-cent error between the terminal and 
multiplexer baud rate is acceptable. 

To find the IPP required for any given baud rate, calculate: 

IRP = (14400/BAUD)-1 

Then use the resultant IPP (an integer) in the original formula to 
calculate the actual baud rate and verify that the actual baud rate is 
within one per-cent of the desired baud rate. 

For example to obtain a multiplexer output at 110 baud: 

(14400/110) -1 = 129.91 

IPP = 129 
BAUD = 14400/(129+1) 
BAUD = 110.77 

The baud rate 110.77 is within one per-cent (for example, plus or 
minus 1.1) of 110 baud, which is acceptable. A better value for the 
IPP would have been 130, which yields an actual baud rate of 109.92 
baud . 



All possible baud rates between 56 and 2400 baud are not available; 
however, all the common ones, including all the available baud rates 
on HP terminals at 2400 baud and below, are usable. 



SET PECEIVE SPEED 



By issuing an EXEC control request to a Multiplexer logical unit, the 
user can set the baud rate at which the Multiplexer expects to receive 
data from a terminal. The terminal must be physically set to transmit 
at that speed. 

The function code is octal 5. To form the control word add the LU 
number of the terminal to 500B. An additional parameter is reauired to 
pass the rate parameter (IRP). 
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A typical calling seauence to set the receive speed would be: 

ICODE = 3 

ICNWD = LU + 500B 

IPP = (14400/IBAUD) - 1 

PEG = EXEC (ICODE / ICNWD , IPP.) 

Where the value of IBAUD is the desired baud rate, and LU contains the 
LU number of the port. 



To set receive speed from the File Manager use the CN command. For 
example, to set LU 10 to 2400 baud (IPP = 5) : 



:CN,10,5B,5 



SET SEND SPEED 



In a manner similar to setting the receive speed, the user can set the 
baud rate at which the Multiplexer sends data to a terminal. The 
terminal must be physically set to receive at the desired baud rate. 



The function code is octal 16, and the required parameter is the same 
rate parameter (IPP) as is used to set the receive speed. The send and 
receive speeds do not have to be set to the same baud rate. 



A typical calling sequence to set the send speed is: 
ICODF = 3 

ICNWD = LU + 1600B 

IFP = (14400/IBAUD) - 1 

PEG = EXEC (ICODE, ICNWD, IPP.) 

Where the value of IBAUD is the desired baud rate, and LU contains the 
LU number of the port. 



To set send speed from the File Manager use the CN command. For 
example, to set LU 10 to 2400 baud (IPP = 5) : 



:CN,10,16B,5 
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ATTACH LOGICAL DRIVER 



The logical driver, or default TTY driver, that is associated with a 
specific LU number will generally remain static once the Multiplexer 
terminals have been initialized. It is therefore advisable tc 
initialize each Multiplexer terminal at boot-up and attach the proper 
logical driver at that time. This does not preclude changing the 
logical driver later. 

It is not recommended that logical drivers be attached using the File 
Manager CN command due to the possibilities for errors; however, the 
default TTY driver can be specified using that method. 

When a logical driver is attached to DVSOO, the address of the logical 
driver must be specified. To get the address of logical driver LDVR5, 
the driver must be called as a subroutine, and passed a parameter in 
which to return the address. This parameter is then passed to DVSOO 
via a control request with a function code of octal 25. 



For example to attach LDVR5 to the physical driver: 

CALL LDVR5 ( IADDR) 
ICODE » 3 

ICNWD = LU + 2500B 

REG = EXEC (ICODE , ICNWD, IADDR) 



The first call to the driver after LDVR5 is attached will change the 
driver type to 05. Note that the type number does not completely 
describe the characteristics of a driver. For proper operation, always 
consult the reference manual for the particular driver in question. 



Change 1 
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The same calling sequence in Assembly language: 
EXT EXEC ,LDVR5 EXTERNAL REFERENCES 



J SB 
DEF 
DEF 
LDA 
ADA 
STA 
J SB 
DEF 
DEF 
DEF 
DEF 



LDVR5 
* + 2 
IADDR 
LU 

=B2500 

ICNWD 

EXEC 

*+4 

I CODE 

ICNWD 

IADDR 



CALL LDVR5 

DEFINE RETURN ADDRESS 

DEFINE STORAGE FOR DRIVER ADDRESS 

FORM 

CONTROL WORD 
AND SAVE 

TRANSFER CONTROL TO SYSTEM 

DEFINE RETURN ADDRESS 

DEFINE EXEC CODE LOCATION 

DEFINE CONTROL WORD LOCATION 

DEFINE LOGICAL DRIVER ADDRESS LOCATION 



IADDR BSS 1 

ICNWD BSS 1 

ICODE DEC 3 

LU BSS 1 



STORAGE FOR LOGICAL DRIVER ADDRESS 

STORAGE FOR CONTROL WORD 

EXEC CODE 3 

STORAGE FOR LU NUMBER 



NOTE 

Programs that call LDVR5 by name must be loaded with access 
to the SSGA area by using the Loader OP,SS command or by 
declaring during system generation that the program type is 
18 or 19. Types 18 and 19 are types 2 and 3 with 16 added to 
the type number to specify SSGA access. 



The first call to the driver after LDVR5 is attached will change the 
driver type to 05. 

To reassign the default TTY driver, simply pass a 0 to DVS00 in the 
address parameter: 

IADDR = 0 

REG = EXEC (ICODE , ICNWD, IADDR) 

The default TTY driver also may be reassigned using the File Manager 
CN command: 

:CN,lu,25B,0 

Reassigning the default TTY driver returns the driver type to 00. 

NOTE 

Request an Update Terminal Status whenever you attach LDVR5, 
to ensure that the logical driver is aware of the current 
terminal strapping configuration. 
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UPDATE TERMINAL STATUS 

An Update Terminal Status call is a control request with a function 
code of octal 32, updating the driver with respect to the current 
status of the terminal strap settings. No parameters are required; the 
driver obtains this information directly from the terminal when this 
call is made. 

Make a Update Terminal Status call whenever the BLOCK MODE switch or 
terminal internal straps are changed and whenever the logical driver 
LEVR5 is attached to the physical driver for a specific port. 

For example, to update the status of the driver for LU number 41, the 
following code could be used: 



I CODE = 3 

ICNWD = 3200B + 41 

REG - EXEC ( ICODF , ICNftD ) 



Or, using a File Manager CN command to make the same status update: 

:CN,41,32B 



ENABLE TERMINAL REQUESTS 

The Enable Terminal control recruests set six terminal conditions and 

initialize the 12920B Multiplexer hardware to communicate with a 

terminal. The function cede is octal 20. One parameter word (IPPPM) 

specifies the si'X conditions. The functions of the bits in the 

parameter word are specified in Table 2-2. The meanings of the various 
conditions are detailed in the following sections. 
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Table 2-2. Enable Terminal Parameter Word 

— — . . — — _ — _ — + 

I Pits | Meaning I 



I 15 I Must be a 1 I 

I 14 I Must be a 0 I 

I 13 I Action on time-out I 

I |0= Down device I 

I I 1 = Do not down device I 

I 12 I Backspace mode (default TTY driver only) I 

I |0= Echo underscore on backspace I 

i I 1 = Do not echc underscore on backspace I 

I 11 - 9 I Net used I 

I 8 I Stop bits I 

I 10=1 Stop bit I 

I 11=2 Stop bits I 

I 7 I Echo mode I 

I 10= Echo off I 

I |1= Echo on/enabled I 

I 5 and 4 | Parity I 

I 10= Parity off I 

I |1= Parity odd I 

I 12= Parity even I 

I 3-0 j Character size; size not including stop and parity bits | 

+ — — . < . — — . + 



The default parameter word is octal 100210, which specifies: 

Backspace Mode: Echo underscore on backspace 

Time-out Action: Down device 

Stop Bits: One 

Echo: On 

Parity: None 

Character Size: 8 bits 



The sequence required to enable a terminal with a parameter word of, 
for example, 130210 octal is as follows: 

ICODE = 3 

ICNKD = LU + 200 0B 

IPP£M = 130210B 

PEG = EXEC (ICODE , ICNWD , IPPAM) 
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The File Manager CN command can be used to initialize a terminal in 
the following manner: 

:CN, lu,20B,130210B 

Specifying a parameter word value of 0 will invoke the default 
conditions if these conditions have not been changed since boot-up. If 
these conditions have been changed, a parameter word value of 0 will 
enable the terminal with the conditions that were established by the 
previous Enable Terminal request. 



Time-Out Action 



A time-out occurs when a device takes longer than a predetermined time 

to complete a request (read, write, or control) , or some error occurs 

and is reported as a time-out (all errors cause time-outs). The 

time-out period may be set by the user, as described later for the 

"Set Time-Out" control request for the LDVP5 only. 



The action that occurs when there is a time-out is determined by bit 
13 of the Enable Terminal parameter word. If bit 13 was "0" when the 
terminal was enabled, the device LU is downed by the system whenever a 
time-out occurs. If bit 13 was "1" the device LU is not downed on a 
time-out. 



If the device is not set down, control is returned to the calling 
program and bit 4 of EQT5 is set. This bit can be checked by a status 
call, as described under "I/O Status" in the section on Status and 
Error Handling. 



A downed device LU must be set UP 
EOT number associated with the 
Reference Manual for details. 



using the system UP command on the 
LU. See your PTE Operating System 
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Backspace Mode 

Bit 12 in the Enable Terminal parameter word controls the way the 
default TTY driver echoes backspace (CNTL-A , CNTL-H, or CNTL-Y) to a 
terminal. Pespcnse to backspace also depends on how you set "Echo" 
mode, described later. 



If bit 12 in the Enable Terminal parameter word is set to "1" and echo 
is on, the driver echoes only a backspace. Echoing the backspace moves 
the cursor one space to the left but does not erase the character at 
the new cursor position from the screen. Most hardcopy terminals 
backspace the print head one position. 

If bit 12 is "0", the driver echoes the backspace followed by an 
underscore (octal 137, left arrow on some terminals). This replaces 
the last character printed (writes over on hard copy terminals) with 
the underscore. The cursor returns to its original position, one space 
to the right of the underscore. If echo is off, the backspace is not 
echoed; however, the underscore may be sent as controlled by bit 12. 

Repeated backspaces in the backspace-underscore mode will have no 
further effect on the display. In the backspace only mode, repeated 
backspaces will move the cursor one space to the left for each 
backspace. Thus, setting bit 12 to "0" is useful on terminals that do 
not reposition the cursor or print head in response to the backspace. 
For such terminals, the number of underscores or back-arrows gives 
visual indication of the number of backspaces entered. 



If you delete the entire buffer, the default TTY driver sends a slash, 
LDVP5 sends a backslash CP/LF to the terminal. 



In either mode each backspace typed deletes the last character from 
the users buffer. This means that to correct an error at the beainning 
of a line everything after the error must be retyped, even though the 
text may still be intact on the terminal screen. 

The backspace with underscore option is available only v/ith the 
default TTY driver. LDVR5 forces backspace without underscore 
regardless of bit 12. 
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Stop Bits 

Bit 8 in the Enable Terminal parameter word specifies the minimum 
number of stop bits inserted between characters on a data line. There 
is no maximum number, as all bits encountered prior to a start bit are 
considered stop bits. Figure 2-1 illustrates the sequence of data bits 
for one character. 



+ — = , _ S , , . _, — + 

III III 
1 II 0 I 1 I 0 0 0 0 0 I 1 I 0 I 1 1 1 



Start LSB— — -Character— --—MSB Parity Stop Bits 
Bit 

(Note timing resynchronized by Start Bit) 

Figure 2-1. Character Sequence for Letter "A" 

A "0" in bit 8 specifies one stop bit. £ "1" in bit 8 specifies two 
stop bits. If the baud rate is 110, two stop bits are used and bit 8 
is ignored. 



Echo Mode 



Echo is the feature of the driver that causes characters to be printed 

on the screen as they are typed on the keyboard of a terminal. For 
certain inputs, such as access passwords, users may want to turn echo 
off. 



When bit 7 in the Enable Terminal parameter word is "0", echo is 
turned off; when it is "1", echo is turned on. When using LDVP5, and 
bit 7 is set to "1", echo is controlled by bit 8 of the read reauest 
control word for each individual read request. If echo is off, bit 8 
is ignored and assumed to be zero. 



NOTE 

This is a hardware bit-for-bit echo; the echoed hits are at 
the received rate. If transmit and receive rates are 
different, turn echo off. 
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Parity Checking 

When parity is specified, an extra bit is sent along with each- 
character. This bit is set to a "1" or a "0" to make the total number 
of 1 's in the binary character odd (or even). When the character is 

received, if the total number of l's is not odd (or even) it can be 
assumed that a bit error has occurred in transmission. 



Pits 5 and 4 of the Enable Terminal parameter word specify the parity. 
A 1 (binary 01) specifies odd parity will be used; a 2 (binary 10) 
specifies even parity will be used. A 0 (binary 00) specifies no 
parity; in this case no parity bit is sent or expected. 



On an HP terminal when no parity is selected at the keyboard, a "0" is 
always sent as the parity bit; therefore, when using an HP terminal 
with no parity, the character size should be set at 8 bits (see 
"Character Size") even though the terminal is sending a 7-bit 
character plus 1 bit of parity that is always a "0". When using even 
or odd parity, specify proper parity and a character size of 7 bits. 

NOTE 

Odd, or even parity checking is available for ASCII reads 
and writes only. Parity checking and parity generation must 
not be used for binary reads or writes. 



Character Size 

The value in bits 3 through 0 of the Enable Terminal parameter word 
specifies the number of bits in each character, not including start, 
stop, or parity bits. 



Enable Terminal Example 



Figure 2-2 shows a program example that could be used to initialize a 
terminal for use with the Multiplexer. Run program INIT from the 
WELCOM file once for each terminal on the Multiplexer. For example, 
four terminals on LU's 22 through 25: 

:PU,INIT,2 2 
:PU,INIT,23 
:PU,INIT,24 
:PU,INIT,25 
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F.TN4 , L 

PROGRAM INIT (19), ***PPOGPAM TYPE SPECIFIES SSGA USE 

C 

C THIS PROGRAM INITIALIZES A MULTIPLEXER TERMINAL. 

C LU NUMBFR OF terminal IS PASSED IN FIRST PARAMETER. 

C 

DIMENSION LU(5) 

DATA IBAUD/5B/,IPS/500B/,ITS/16C0B/,LDVR/2500B/ 

DATA IENAB/2000B/,IPRAM/130210B/,ICODE/3/,IUPST/3200B/ 

C 

C GET LU NUMBER 
C 

CALL RMPAR (LU.) 

C 

C SET RECEIVE BAUD RATE AT 2400 BAUD 
C 

ICNWD = LU + IPS 

REG = EXEC (ICODE , ICNWD , IBAUD) 

C 

C SET TRANSMIT BAUD RATE AT 2400 BAUD 
C 

ICNWD = LU + ITS 

PEG = EXEC (ICODE, ICNWD, IBAUD) 

C 

C GET LOGICAL DRIVER ADDPESS AND PASS TO PHYSICAL DRIVER 
C 

CALL LDVP5 (IADDR ) 
ICNKD = LU + LDVP 
PEG = EXEC (I CODE, ICNWD, IA DDF) 

C 

C UPDATE TERMINAL STATUS 
C 

ICNKD = IUPST + LU 

REG = EXEC (ICODE , ICNKD) 

C 

C ENABLE TERMINAL KITH BACKSPACE, NO DOWN ON TIME-OUT, ONE STOP 

C BIT, NO PARITY, AND 8 BIT CHARACTERS 

C 

ICNWD = LU + IENAB 

PEG = EXEC (ICODE, ICNWD, IPRAM) 

END 

END$ 

Figure 2-2. Enable Terminal Example: Program INIT 
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Once an LU has been initialized, it is ready to perform its principal 
function, input and output. Most input and output through the 
Multiplexer is initiated by high-level language FEAD and WPITE 

statements . 



These I/O statements generate calls to library modules that make EXEC 
calls to PTE . When using high-level language I/O statements, you may 
be communicating with a DVSOO, LDVP5, or a non-Multiplexer terminal. 
The specific calls to different types of devices are handled by the 
library modules and the PTE operating system. 

There are, however, times when you need to control the driver directly 
in order to handle a special case data transfer that would not be 
possible with the more general high level language I/O statement. 

This section tells you how to use EXEC calls to communicate directly 
with the driver. 



USING TKF DEFAULT TTY LOGICAL DPIVFR 



Pead or write requests using the default TTY driver are in the form of 
EXEC calls with a request code (ICCDE) of 1 for read and 2 for write. 
The control word (ICNWD) must contain the LU number of the Multiplexer 
device. The default TTY driver ignores all other bits in the control 
word . 



For both reads and writes two more parameters are required. Buffer and 
buffer length parameters must be passed to the driver by the FXEC 
call. 



The buffer length must in all cases be less than or equal to the 
storage reserved for the buffer. For a write request the buffer must 
be less than the line length of the terminal, unless the terminal has 
a wrap-around mode. 

The buffer length parameter may be positive or negative. If positive, 
the length specified is the number of words. If negative, the length 
is the number of characters. 
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As an example, the following sequence writes seven characters from a 
buffer called IOUT to LU 41, then reads five words from the same LU to 
a buffer named INBUF: 



• 

ICODE = 2 
ICNWD = 41 
IBUFL = -7 

REG = EXEC (ICODE, ICNWD, IOUT, IBUFL) 
ICODE = 1 
IBUFL = 5 

REG = EXEC (ICODE, ICNWD, INBUF, IBUFL) 



Some points to consider when making read and write requests to default 
TTY driver DVSOO: 

o Input and Output are ASCII only; binary mode not permitted. 

o On read, a carriage return (CR) is interpreted as an end of 
record (EOR) and a carriage-return line-feed (CR/LF) is 
echoed unless echo is turned off. 

o On write, the driver adds CR/LF to each record unless the 
last character is an underscore. If the buffer length is 
specified by a positive integer, an even number of 
characters is sent to the terminal. Take care that the 
underscore is the last character in the string if CR/LF 
suppression is desired. 

o The driver ignores line feeds and leading nulls on reads. 

o The driver will accept zero-length records from the 
terminal. > 

o There is no transparent mode (inhibit special character 
processing) for the TTY driver. 



LDVR5 TO KEYBOARD/DISPLAY 



Read/write requests to a keyboard/display cover three types of data 
transmission: writing to a display (request code 2) , and two types of 
reads from a keyboard (request code 1) . The two types of reads are 
character mode read and block mode read. 
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In character mode read with echo on, the driver enters each character 
into the buffer and the hardware echoes the character back to the 
display as it is entered at the keyboard. In block mode read, the 
terminal saves characters in display memory until either the FNTEP key 
is pressed or the program initiates a block read. The block can 
consist of one line or one page of characters, depending on terminal 
strapping . 



Function Code 



A read or write request to a keyboard/display using LDVP5 is the same 
as a read or write request using the default TTY driver except that 
the function code, bits 10 through 6 in the control word (TCWn) are 
set by the user to control the driver and terminal. The functions of 
the control word bits are shown in Table 2-3. 



Table 2-3. Keyboard/r isplay Pead/Write Fequest Control Word for LFVF5 
+ , . — ~ — . — - + 



Bits 



Function 



15-11 
10-9 



7 
6 

5-0 



Not used. 

00 = Non-transparent character mode; terminal can initiate 

block or character reads. 

01 = Not used. 

10 - Transparent character mode; terminal can initiate 

character or block reads. 

11 = Program-initiated block reads. 

1 = Fcho on if enabled. 

0 = Echo disabled. 

Not used. 

1 .= Binary transfer. 
0 « ASCII transfer. 

LU number of terminal. 
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Since bits 10-9 and bits 8-6 have distinct meanings, the function code 
can be described in terms of its first and second octal digits: 

First digit of function code: 

0 = Non-transparent character mode 

2 = Transparent character mode 

3 = Program-initiated block read 

Second digit of function code: 

0 = ASCII transfer without echo 

1 = Binary transfer without echo 

4 = ASCII transfer with echo 

5 = Binary transfer with echo 



As an example, the following sequence writes seven characters from a 
buffer called IOUT to LU 41, then does a read of five words from the 
same LU to a buffer named INBUF. The "normal" mode (ASCII data, 
non-transparent mode, function code = 0) is used for the write. The 
read uses ASCII data with echo on, function code = 4): 



I CODE = 2 

ICNWD =41 

IPUFL = -7 

PEG = EXEC (ICODE ,I0 1 VJB, IOUT,IBUFL) 

ICODE = 1 

IBUFL = 5 

ICNWD = 41 + ^OOB 

REG = EXFC( I CODE, ICNWD, INBUF, IBUFL) 
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Writing to a Display 

Programming write requests to a display requires consideration of 
several points. The output is a string of ASCII characters from a 
buffer in which each word contains two characters. The buffer length 
must be specified by a positive integer if you count the words, or by 
a negative integer if you count the characters. In either case, the 
driver terminates the character string by supplying a carriage return 
and line feed. 

The length of the buffer must be limited to terminal display width 
unless the terminal has an End-of-Line Wrap Around mode enabled. 

The CP/LF at the end of the character string can be suppressed by 
using the underscore character (137 octal) . In the non-transparent 
(normal) mode the underscore must be the last character in the buffer. 



In non-transparent mode, if the underscore is the last character in 
the string, the underscore CP and LF are not sent to the terminal. In 
transparent mode, an underscore anywhere in the text string will 
suppress the CR/LF, but the underscore will be sent to the terminal. 



NOTE 

If the buffer length is specified by a positive integer, an 
even number of characters is sent to the terminal, appending 
a space to the text if necessary. Take care to ensure that 
the underscore is the last character in the string and not 
followed by a space if suppression of CR/LF is desired. 

Write requests can pass escape and control sequences to the terminal 
to control various terminal functions. Consult the terminal User's 
Manual for a description of these functions. 

When writing in the binary mode (bit f =1) all ESC characters are 
stripped from the character string except when the EOT subchannel is 
3. This is useful when using the Graphics features of a 2MPA 
terminal . 
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Block Mode Keyboard Pead 

For keyboard read requests, the driver maintains a record of the 
terminal status: character, block line, or block page mode. Keep this 
status current by requesting "Update Terminal Status" whenever the 
status is changed or when the logical driver LDVR5 is attached to the 
physical driver for a specific port. For insurance, your programs can 
request Terminal Status Update at any time. 

In block-mode keyboard reads, terminal transmissions are either 
line-by-line or page-by-page, depending on the terminal strapping. 
With page strapping, line separators (CR/LF) are passed to the user's 
buffer but the data terminator (PS) is not. With line strapping, 
embedded PS's are passed to the user's buffer but the data terminator 
(CP) is not. In both cases the unit separator (US) is passed to the 
user 's buffer . 



For terminal-enabled block read (function code first digit = 0 or 2) , 
the user composes a line or page on the terminal display then presses 
the ENTER key on the keyboard. For program-enabled block read (first 
digit of function code = 3) , the user also composes the line or page 
but the read completes when the program requests, without waiting for 
the FNTFP key to be pressed. 

For program-enabled block reads, the program must position the cursor 
properly for the read. When the program requests a block read, the 
read progresses from the current cursor position to the end of the 
current line or page, depending on terminal strapping. For 
terminal-enabled block reads, the ENTER key positions the cursor. 

In terminal-enabled block mode, all prompts before input should have 

ESC, underscore as the last two characters printed. Transparent mode 

prints the underscore, but ESC suppresses the actual display of the 
underscore. The ESC-underscore places a non-displayed terminator after 

the prompt, preventing it from being transmitted along with the user 

input when the ENTER key is pressed. 

In block mode reads, the text that is on the display (in the 
terminal's display memory) is what is sent to the computer. Control 
codes and escape sequences that do not print on the display will not 
be sent unless they are made visible when entered by using the DISPLAY 
FUNCTIONS key. 
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Character Fode Keyboard Read 

In character-mode keyboard-read requests, the terminal transmits one 
character each time a key is pressed. The record terminator is a CF 
and must be entered to complete the request (the terminator is not 

sent to the user's buffer). At reception of the CF: the driver echoes 
CF/LF and completes the request, passing the transmission log (number 
of characters or words sent) to the F Fegister. 



In non-transparent character mode, the driver processes the following 
special characters: 

o DEL (PUBOUT, 177 octal). Fntering BEL (shift-underscore) 
deletes the current record and outputs a backslash (\) , CF, 
and LF; this deletes the line and starts a new line. 

o BACKSPACE (10 octal). Pressing the E^CFSPACF key deletes the 
last character; the cursor moves back one position. The BS 
is not sent to the user's buffer. 

o LINE FEED (12 octal). A line feed (LF) is echoed back to the 
display but is not sent tc the user's buffer. 

o CCNTPCL D (4 octal). Entering CNTL-D (CNTL and D keys) 
terminates data transmission and sets status word (EOT5) bit 
5 to a "1" with all r?ercs in the E-Fegister. 



In the transparent mode, the special characters listed above are not 
processed by the driver but are passed to the user's buffer. 

The echo bit (bit 8) in the control word turns on echo mode. If the 
terminal was enabled with echo on, echo remains off only for the read 
request in which bit 8 in the control word is "0". Echo has no meaning 
for write requests. If echo was specified as off when the terminal was 
enabled, the echo bit in a read request control word has no effect, 
and is assumed to be zero. 
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INITIALIZATION REQUESTS 



o A binary write request writes a word (or character) string 
from a buffer of specified length. The driver rejects 
requests for zero length, or for greater than the maximum 
length (128 words) . 

o Parity is not permitted with binary reads or writes. 

o An ASCII read request reads a word (or character) string 

t-prmi na(-pH h\/ a parrianp rpfnrn. Tf t"hf> Rnpri f ipri huffpr 
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LDVF5 TO AN AUXILIAPY PFINTEP 



Write requests to an Auxiliary Printer connected to a terminal are 
handled in the same manner as write reauests to the keyboard/display. 
The request code (ICODE) value must be a 2 for write. The control word 
(ICNVJD) nnust contain the LU number of the printer in bits 5 throuah 0. 
The remaining bits of the control word are ignored; only ASCII, 
non-transnarent writes are allowed. 

The keyboard/display and Auxiliary Printer connected to the terminal 
will have different LU numbers. The LU number of the printer is 
associated with EOT subchannel 4. 



A buffer and buffer length must be specified. The buffer length can be 
positive, for words, or negative, for characters. The buffer length 
must not exceed the maximum line length of the printer. Refer to the 
printer User's Manual for line lengths. 

The driver supplies the printer with a CP/LF at the end of each line 
(record). If the buffer contains a CP, LF, or PS, the driver 
terminates the request. 

LDVP5 does not support the Peverse Line Feed and Plotting capabilities 

of the HP 9871A Printer; however, escape secruences to perform various 
functions on the 9871A can be passed. 

For example, to print a line of text (80 characters) on an Auxiliary 
Printer on LU number 41, the following code could be used: 



• 

ICODE = 2 
ICNWD =41 
IBUFL = -8 0 

PEG = FXEC (ICODE, ICNWD , IBUFF, IBUFL) 



where IBUFP contains the 80 characters. 
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RFTUFNS 



Two information words are available when a read or write request 
completes. The A-Pegister contains the device status word and the 
B-Pegister contains the transmission log, equal to the length of the 
data in the user's buffer. 



On write reouests, however, the information is meaningless if the 
device is buffered. Device buffering refers to a buffer in addition to 
user's buffer IBUFP. Device buffering is established at system 
generation time or on-line by the system FQ command. 

V-hen a write request is issued to a buffered device, the user's buffer 
is transferred into a buffer in System Available Memory (SAM) and the 
output processing started. Control is returned to the user program 
before the actual output is finished, so the device status and 
transmission log are meaningless. 

After read requests, and after write reauests when the I/O device is 
unbuffered, the A- and E-Pegisters contain the completion status. 



Getting Completion Status 



To get completion status from the A- and E-Pegisters in a FCPTP^N 
program, call EXEC as a function. The following code shows how to use 
this method: 

DIMENSION IREC(2) 

EQUIVALENCE (PEG,IPEG) , ( IREG , IA ) , (IREG (2) ,IB) 



ICCDF = 1 

ICNKD = LU + 40 OB 
IBUFL = -80 

PEG = EXFC (ICODE , ICNfcD , IBUFP , IBUFL) 



The variables I A and IB now contain the A- and F-Fegister contents, 
device status word and transmission log respectively. 
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An alternative method is to use the library subroutine ABPEG: 



CALL EXEC (ICODE , ICKWD , IBUFP , IBUFL) 
CALL ABPEG (IA ,IB) 



IA and IB contain the A- and B-Register contents, provided ABPEG is 
called immediately after the EXEC call. 



Status Word 



The status word in the A-Pegister indicates the end-of-operat ion 
status as defined by the driver completion code in bits 15 and 14 of 
the word. This is either "00" (up) or "01" (down). The equipment type 
code, in bits 13 through 8, will be 00 octal. Bits 7 through 0 contain 
the physical status of the device or port. 



The status word is word 5 of the Equipment Table Entry for the device. 
Appendix A describes the Equipment Table Entry. The meaning of word 5 
(EQT 5) is described for IPTAl under "I/O Status" in this Section. 



Transmission Log 



The transmission log is a positive integer equal to the character or 

word count of the data in the user's buffer. If the value of buffer 
length parameter IEUFL in the preceding EXEC call was positive, the 
transmission log in the B-Pegister is the word count. If the value of 
IBUFL was negative, the transmission log is the character count. 
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Control requests that apply to both the loaical and physical drivers 
include setting the EOT bit in a device status word, setting speed 
sense mode to enable the Multiplexer to detect the baud rate of a 
terminal, and setting a port to the buffer flush condition. Also in 
this category is the disable terminal recuest. 

This subsection describes the above recuests, and also describes the 
CP/LF delay request, applicable only to the default TTY driver. These 
are control requests, performed by calling FXFC with the first 
parameter (ICODF) set tc 3 and the second parameter (ICNWD) containing 
the function code in bits 10 through 6 and the logical unit number 
(LU) in bits 5 through 0, as described under "Control Word" at the 
beginning of this Section. 



SFT EOT STATUS 



Issuing a control request with a function code of 7 octal sets the 
Fnd-of-Tape status bit in the device status word (EOT 5 bit 5). This 
has the same effect as reading an Fnd-of-Tape (EO^) from a CTU, or 
entering a CKTL-B from the keyboard in the non-transparent mode. The 
following code is an example of setting EOT status on LU 41: 



ICOPP = 3 

ICW'P = 70 OB + 41 

PFC = FXFC (ICODF , ICNWH) 



— or — 

:C*',41,7R 

Set FCT status is supported by both the default TTY driver and LFVP5. 



SET CP/LF CFLAYS 



Carriage return and line feed delays are required by some printers to 
allow time for the carriage or print head to return to the left margin 
before starting to print the next line. Also, some terminals require a 
delay to avoid overflowing the internal buffer. 
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A symptom of too short a CR/LF delay on a printing teririnal is 
printing a character between the normal lines of text on a carriage 
return. HP 2640-series terminals display a half-bright rectangular 
"DEL" character (octal 177) if the internal buffer overflows. Consult 
the device User's Manual for CR/LF requirements. 



One CP/LF delay, is always sent. Additional delays can be set in 
increments of one character time (the transmission time for one 
character at the baud rate of the terminal) by specifying a number of 
stall characters for carriage return and line feed. 

To set the delays, use a control request with a function code of 12 
octal. One additional parameter is required (IDELY) in which bits 7 
through 4 contain the number of stall characters for CR and bits 3 
through 0 contain the number of stall characters for LF. 



For example, to set a CR delay of 4 and an LF delay of 3 on LU 41, the 
following code could be used: 



I CODE = 3 

ICNVD = 1200B +41 

ICR = 16 * 4 

C 

C MULTIPLY BY 16 = SHIFT LEFT 4 
C 

I LF = 3 

ID^LY = IOR(ICR,ILF) 

REG = EXEC(ICODE,ICNWP,IDFLY) 



or 

:CN,41,12E,10 3P 



Setting CR/LF delays is only supported by the default TTY driver and 
is not used when LPVR5 is attached to PVSOO. For this purpose, LPVP5 
uses an enquiry/acknowledge handshake. 
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SET SPEED SENSE MODE 



Using a control request with a function code of 17 octal, it is 
possible to have the Multiplexer hardware detect the operating baud 
rate of a terminal and report that baud rate to the driver. The 
reported baud rate is established as both the transmit and receive 
baud rates by the driver. 

One additional parameter is required (ICFP) , to contain a "search for" 
character, right justified. The user must type the "search for" 
character in from the keyboard within one minute after issuing the 
request (other characters are ignored). 

On receipt of the request, the driver puts the selected port into the 
Speed Sense (diagnostic) mode for one minute; if the correct character 
is not input within that amount of time, the driver times out, setting 
bit 4 of the status word to "1" to signify time-out, and setting the 
baud rate to 240C. 

If the correct character is input from the port, the sensed speed is 
set as both the transmit and receive speeds, and the driver makes a 
normal completion. The speeds sensed are 110, 150, 300, 600, 1200, and 
2400 baud. Since both the send and the receive rates are set, 
split-speed operation is not possible, unless *-he transmit rate is 
reset upon completion. 

For example, to sense the baud rate on LU 41, using the CP character 
(user must press RETURN) the following code could be used: 



ICNWD = 1700B + 41 
ICEP = 15B 

C 15 OCTAL IS CARRIAGE RETURN, USER MUST FIT RETURN 
C WITHIN ONE MINUTE 

PEG = EXEC (ICODE, ICNWD, ICHP) 



— or — 

:CN,41,17B,15B 



The speed sense mode is supported by both LDVP5 and the default TTY 
dr iver . 
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DISArL'E TERMINAL 



A control reouest with a function code of 21 octal will disable the 
terminal assigned to the addressed LU number. When a terminal is 
disabled, bit 0 of the status word is cleared, ^his means that 
striking a key on the keyboard will not schedule the program that was 
specified at generation. Read, write, and control requests to the 
terminal will still function normally. To re-enable the terminal an 
"Enable Terminal" request must be issued. 



For example, to disable LU 41: 



ICODE = 3 

ICNWD = 2100B + 41 

PEG = EXEC(ICODE,ICNWD) 



-- or 

:CN,41 ,21B 

Disable terminal r>ay be used with either the default TTY driver or 
LDVP5. 
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BUFFEP FLUSH 



Issuing a control request with a function code of 23 octal will put a 
port in the buffer flush condition. In this condition, the driver 
ignores all write requests and control requests for the designated 

port. Read requests only are honored. 



To establish the buffer flush condition, the driver sets bit 7 of the 
device status word. Bit 7 is defined for both the default TTY driver 
and for LDVP5 to indicate the buffer flush condition. See "I/O Status" 
for a description of related status conditions. 



The buffer flush condition is removed automatically when a read 
request is processed or the queue (a list of programs with requests 
pending against the EOT) is empty. The buffer flush condition may also 
be removed by issuing the "Buffer Unflush" control request. 



NOTE 

A buffer flush condition may also be established by a 
communication line failure. 



To establish a buffer flush condition the following example could be 
used : 



ICODE = 3 

ICNWD = 2300B + 41 

REG = EXEC (ICODE, ICNWD) 



■ — or -- 

:CN,41 ,2 3B 

A buffer flush condition can be established while using either the 
default TTY driver or LDVR5. 
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BUFFER UNFLUSF 



To remove a buffer flush condition, issue a control request with a 
function code of 24 octal. Buffer unflush restores the use of write 
requests and control requests after a buffer flush, and clears the 
buffer flush bit (bit 7) in the status word. It alsc clears the bad 
communications line, time-out, and ^OT bits (bits 2, 4, and 5, as 
listed in the "I/O" Status" subsection). 



A buffer unflush shculd be used in the recovery from a communication 
line failure. Either a read request or queue empty initiates an 
automatic buffer unflush, performing the same function as a buffer 
unflush request. 



To execute a buffer unflush, the following example could be used: 



P. buffer unflush can be used under either the default TTY driver or 
LE VP 5 . 



ICCDF 
ICNKD 
PEG = 



= 3 

= 2400B + 41 
EXEC (ICODE ,ICNKP) 



or 



:CN,41,24B 



NOTE 



If the communications line is still bad, the next request to 
that port may set the port down again. 
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The control requests described in this subsection are used with LDVF5 
only. Fince they pertain to special functions of LDVR5, they are not 
recognized by the default TTY driver. 



FFT TIME-OUT 

To set the PTE device time-out value to something other than the value 
that was established at generation, use a control request with a 
function code of 22 octal. This value can be set in lOO-millisecond 
intervals by the integer provided in an additional parameter. 

Time-out values can also be set by using TO operator command. The FTF 
Programmer's Reference Manual for your system describes how to use the 
TO command. When you use a control request or the File Manager CN 
command, specify the port, or device, by LU number; when you use the 
TO operator command, specify the port by FOT number. 

If the default T^Y driver is used, the only method of setting the 
time-out value is using the RTF TO command. Time-outs set by LDVR5 
remain in effect if the default driver is reenabled. 

To set the time-out on LU 41 to 25 seconds, the following example can 
be used, if LDVR5 is attached to the physical driver: 



I CODE = 3 

ICNWD = 2200B + 41 
ITO = 10 * 25 

RFC = FXEC (I CODE , ICNWD , ITO ) 



or — 
:CN,41,22B,2 50 
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CTU CONTROL 



There are nine functions that are controllable on each Cartridge Tape 
Unit (CTU.) of an HP terminal. These functions can be performed by 
issuing a control request in which the control word (ICNKD) contains 
the LU number of the CTU and a function cede from the list given in 
Table 2-4. 



Table 2-4. CTU Contr ol-Peauest Function Codes 

Descr ipt ion 




Write End-of-File (FOF) 
Backspace one record 
Forward space one record 
Pewind 

Write End-of-File (EOF) if an FCF was not just 
previously written on this CTU 

Forward space one file 

Backspace one file 

Write End-of-Data 

Locate absolute file: parameter required, I FILE 

0 < IFILE < 256 



A rewind, backspace one record, or backspace cne file request will not 

cause any action if the CTU is at the load point. The load point 
status can be reported in a dynamic status word, as described for the 

"Dynamic Status" request. A request for a file number greater than any 
existing on the tape will position the tape to the last file that 
exists. If the terminal is strapped for page mode operation, the BLOCK 
MODE switch must be in the out position. 
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As an example, the following code could position the CTU assigned to 
LU 42 to the start of the first record in file 6: 



ICODE = 3 

ID? WD = 2 70 OP + 4 2 
IFILE = 6 

PEG = FVEC (ICODE, ICWWD, IFILE) 



-- or -- 

: CN , 4 2 , 2 7B , 6 



PFINTEP CONTROL 



control request with a function code of 11 octal issued to an LU 
that is assigned to an Auxiliary Printer (subchannel 4) connected to 
an FP terminal causes the printer to advance the paper a specified 
number of lines. 



The number of lines must be specified in an additional parameter, with 
a value of less than 256. A negative number in the additional 
parameter will cause some printers to go to top-of-f orm, other 
printers will ignore negative parameters. Consult your printer manual 
for reaction to negative spacing parameters. 

As an example, the following code would execute a top-of~form on a 
printer referenced by LU number 44: 



ICODE = 3 

ICNWD = HOOF + 44 
ILINF = -1 

FEG = EXFC(ICODE,ICNWD,ILINE) 



or 

:CN ,44,11B,-1 

The above commands can be used to space a display, with a maximum 
limit of 55 lines, by using the display LU. 
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When communicating with a terminal over a full-duplex modem link, 
control of the modem is relatively simple. To establish communication, 
the Multiplexer must issue a "Data Terminal Ready" to the modem and 
then wait for the modem to respond. 

The modem uses two signal lines to signal the Multiplexer that the 
link has been established. "Data Set Feady" is on whenever the modem 
is turned on and connected to the line, and "Clear To Send" goes on 
when communication has been established with the modem at the terminal 
end. The corresponding communications at the terminal end are taken 
care of automatically by the modem and the terminal. 



OPEV L INF 



£ control request with a function code of 31 octal initiates a modem 

connect sequence on one port. The Multiplexer issues the "Data 

Terminal Feady" and the call does not complete until the Multiplexer 

receives "Data Set Ready" and "Clear To Send", or the port times out. 

An additional parameter is needed to set the time-out for the Open 
Line call. This parameter must be specified as the negative of the 
number of one-tenth second intervals for time-out. A zero or a 
positive value specifies that the port will not time out while waiting 
for a modem line connection. 



The time-out value must be long enough for the connect to complete. 

This time could be anywhere from a few seconds if the terminal end is 

tied in and ready to go, to a maximum time of 54 minutes if the 

terminal end must be powered up, phone dialed in, and modems 
connected. The time-out specified replaces the system assigned 

time-out described under "Set Time-Out" for the Open Line request 
only. 
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The following code is an example of opening a modem line on LU 41 with 
a 10 minute wait for a line connect: 



I CODE = 3 

ICNWD = 3100P + 41 
ITO = -6000 

PEG = EXEC (ICODE, ICNWD, ITO) 



— or —- 

:CN, 41,31* ,-6000 



An Open Line control request can be used with either the default TTY 

I driver or with LDVR5. The open line request is always executed, re- 
gardless of any buffer flush condition. 



CLOSE LINE 

To provide an orderly termination of modem line communications, use 
the Close Line control recuest, which specifies a function code of 30 
octal. The Close Line request sets the "Data Terminal Peady" line down 
from the Multiplexer to the modem, causing the modem to initiate a 
disconnect from the phone line. The request waits five seconds to give 
the phone line time to break connection, then returns to the user 
program. No additional parameters are required. 

The following code is an example of a disconnect on LU 41: 



ICODE = 3 

ICNWD = 3000B + 41 

PEG = EXEC (ICODE , ICNWD.) 



— — or — 

:CN,41,30B 

The Close Line control request can be used with either the default TTY 
driver or LDVR5. 
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STATUS AND ^PPCF HANDLING 



There are two status calls available to the user to check on the 
status of a Multiplexer port for normal processing and error 
diagnostics. I/O Status can provide the user with two of the device 
status words (EQT5 and EQT4) and an LU status word. Dynamic Status 
provides the user with the status of the CTU 's or Auxiliary Printer on 
a terminal. 



I/O STATUS 



The 31/0 Status request, using a request code (ICODF) of 13, calls the 
PTE operating system to provide information contained in system 
tables. The LU number of the port must be specified in the control 
word (ICNKD) . One additional parameter is reauired and two more are 
optional. One, two, or three words are returned to the user's program 
in the parameters passed. 



A sample calling sequence for LU 41 is shown below: 



ICODE = 13 
ICNWD =41 

CALL EXEC (ICODE , ICNWD , ISTAl , I ST A 2 , ISTA 3) 



When the call completes the variables ISTAl, I ST A 2 , and ISTA 3 contain 
the I/O status as shown in Table 2-5. ISTAl is the status word (FQT5). 



2-45 



-STATUS AND ERROR HANDLING- 

Table 2-5. I/O Status-Request Returns 

+ , . . . . , -< . , + 

I Word I Bits I Description I 

lISTAll 15—14 1 I/O controller availability indicator: I 

I I | 00 = Available for use I 

I | | 01 * EQT disabled (down) I 

I I I 10 = Device busy I 

I I 13-8 | Equipment Type Code = 00 octal ! 

I I 7-0 I Status: 1 = I 

I I 7 | Buffer Flush condition I 

I I 6 | Break key hit I 

I I 5 I Control D entered (EOT) I 

I I 4 I Time-Out occurred I 

I I 3 I In Speed-Sense mode I 

I | 2 | Bad communications line (modem failure) I 

I 111 Pause mode (key struck during output) I 

I | 0 I Terminal Enabled I 



ISTA2I 15 I Not used: always zero 

I 14 I 1 = Automatic output buffering enabled 

I 13 11= Driver tc process power fail (always 0) 

I 12 11= Driver tc process time-out (always 1) 

I 11 11= System communication flag 

I 10-6 I Last subchannel addressed 

I 5-0 I Dummy select code assigned to Multiplexer port 



1 1ST A3 1 I Logical Unit Status: I 

I I 15 | 1 = LU down, 0 = LU up I 

I I 14-5 I Not used I 

I I 4-0 I FQ.T subchannel associated with the LU number I 
+ ■ . + 
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DYNAflC STATUS FEQUEST 



The dynamic status request to a CTU or Auxiliary Printer LU number is 
actually a read request (ICODF = 1) with a function code of 37 octal. 
As witn other read requests, the control word (ICNVD) includes the 

function code and the LU number of the CTU or printer. The buffer need 
only be one word long and the buffer length must be specified as one. 



An example dynamic status request on LU 42 is coded as follows: 



ICODF = 1 

ICNVfD = 3700B + 42 
IBUFL = 1 

PFC = EXEC (ICODF, ICNKD , IBUFP , IBUFI ) 



On return, the first word of the buffer (IBUFR) contains the dynamic 
status for the CTU or printer as specified in Table 2-6. 



NOTE 

Because the dynamic status request is a call tc the driver, 
it will wait until any outstanding request on that EQT is 
completed . 
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-STATUS AND EPPCF BANDLING- 

Table 2-6. Dynamic Status Request Response Lists 



+ — — ■ — __ — — — — - ■ — — — « — + 

I Eit Set I Description I 

I 15 - 8 I Not Used I 

| 7 I End of File (ECF) I 

I 6 I Tape at load point I 

| 5 I Fnd of Tape (EOT) I 

I 4 I Hard read error or write error I 

I 3 I Last command aborted, check other bits for cause; I 

I I bit 3 significant for printers only I 

I 2 I Cartridge write protected I 

I 1 | End of data (ECD) I 

| 0 I Cartridge not inserted or unit busy I 

+• — — . . — . — + 



FAILURE ANALYSIS 



For failure analysis it is important to note that all errors cause 
time-outs. If specified in the "Enable Teririnal" request, the device 
will also be downed, and an error message produced at the system 
console : 

I/O TO L #x F #y S #z 

where x, y, and z are the Logical Unit number, EOT number, and 
subchannel number respectively. If a device is down, the request 

will wait for the operator to UP the EQT number. 

It may be that only a simple time-out has occurred, meaning that the 
operator was too slow in responding to a read request, or a modem, link 
was not established in time. In either case, retry the request a few 
times . 

To recover, always perform a Buffer Unflush, and re-enable the 
terminal before proceeding with operations. 
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INITIALIZATION REQUESTS 



If the device is not downed, control returns to the user program on 
error (time-out) and the user program should be structured to check 
for errors and process accordingly. You can use the "I/O Status" 
request to get the status to test for various conditions. 



Modem Errors 



If a port has been using a modem link, and the communications line 
fails (disconnects) , the driver automatically executes a line-close 
operation and puts the port in the buffer-flush state. When in this 
state, the port ignores all pending requests except buf f er-unf lush and 
line-open . 



Unlike a programmatic buffer flush, the buffer-flush state caused by a 
line failure cannot be removed by a read request; and, when the flush 
is removed by the driver, any subsequent I/O request will return the 
port to the buffer-flush state. 



The recovery procedure after a line failure has placed a port in the 
buffer-flush state depends on whether the port is down or up. If the 
port is down, either of two procedures can be followed. 



If the port is down and all pending requests can be removed, proceed 
as follows: 

a. Remove all requests pending against the EQT. 

b. UP the EQT. 

c. Issue an open line request. 

d. Wait for the communications line to be reestablished. 

e. Restart any aborted process. 



If the port is down and a priority higher than that of any pending 
request is available, proceed as follows: 

a. Issue an open line request at higher priority than any 
pending request. 

b. UP the EQT. 

c. Wait for the communications line to be reestablished. 
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INITIALIZATION REQUESTS 



If the port is not down: 

a. Issue an open line request. 

b. Wait for the communications line to be reestablished. 
Note that I/O requests made while the line was down were flushed. 



CTU and Printer Errors 



If the program was communicating with a CTU or Auxiliary Printer, a 
Dynamic Status request should be performed and the bits in the return 
word checked for error conditions. On the basis of these results the 
operator should be requested to correct the problem. If the device is 
down it must be UP'ed prior to performing the Dynamic Status request. 



Read Errors 



If the last command issued was a read, a parity error or data overrun 
may have occurred. Data overrun means that the Multiplexer maximuir 
throughput rate has been exceeded and data on the LU with the time-out 
bit set was lost. Neither parity error nor data overrun can be 
explicitly tested for by the user, so the best procedure is to retry 
the failed request a finite number of times. 



Program Response to Line Failure 

When a line failure occurs on a port initiated not to be set down on 
errors, the driver responds to read requests with an EOT. Therefore, 
if a port does not set down on error, user programs should be written 
to handle EOT signals in a reasonable manner. For example, interactive 
programs might attempt a finite number of retries, then terminate in 
an orderly fashion. 

Since the driver performs a line close operation when the line is 
broken, the line must be reopened before another call can be answered. 
This can be done manually, from another console, as described above, 
or it can be done programmatically . 

To open closed lines programmatically, a line monitor program can be 
put in the time list to perform an open line request periodically on 
all modem ports. This program needs a priority high enough to ensure 
that it is not locked out by other programs. Figure 2-3 shows an 
example of such a line monitor program. 
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INITIALIZATION REQUESTS 



I FTN 4 , L I 

I PROGRAM LINUP ( 3,41) , * MUX LINE MAINTENANCE PROGRAM * I 

I DIMENSION IPORT(32) I 

I C I 

I C THIS PROGRAM SCANS ALL MULTIPLEXER PORTS USING MODEMS I 

I C (AS DEFINED IN IPORT ARRAY) AND ISSUES AN OPEN LINE REQUEST I 

I C IF THE PORT IS NOT BUSY. IF THE PORT IS BUSY OR DOWN NO ACTION I 

I C IS TAKEN. THIS PREVENTS THIS PROGRAM FROM BEING SUSPENDED. I 

I C NO CHECK IS NEEDED FOR WHETHER THE LINE IS UP OR DOWN. THE I 

I C DRIVER IGNORES OPEN REQUESTS TO PORTS WHOSE LINES ARE UP. I 

I C I 

I C A CHECK IS ALSO MADE FOR TERMINALS LEFT DISABLED. DISABLED I 

I C PORTS ARE GIVEN A BUFFER-UNFLUSH AND THEN ENABLED SO THAT 1 

I C THE NEXT USER DIALING IN CAN SCHEDULE PRMPT (OR WHATEVER WAS I 

I C SPECIFIED AT GEN TIME). IF THIS FUNCTION IS NOT DESIRED, THE I 

I C INDICATED LINES SHOULD BE REMOVED. I 

I C I 

I C !!!! NOTE: ALL PORTS MUST BE BUFFERED !!!! I 

I C I 

I C THIS PROGRAM SHOULD BE PUT IN THE TIME LIST FOR SCHEDULING I 

I C EVERY 10-20 SECONDS. I 

I C I 

I C DEFINE LU OF PORTS TO BE MONITORED; I 

I C CHANGE IPORT DATA TO MATCH YOUR SYSTEM'S LU'S; I 

I C CHANGE NUMPT TO THE NUMBER OF ELEMENTS IN IPORT: I 

I C I 

I DATA IPORT/14,15,16,17,18,19,20,21/ I 

I DATA NUMPT/8/ ! 

I C I 

I C SCAN PORTS: I 

I DO 10 1=1, NUMPT I 

I LU = IPORT (I) : 

I C I 

I C CHECK IF PORT IS BUSY OR DOWN: I 

I CALL EXEC ( 13 , LU , IS TAT, IQ) I 

I IF ( I AND ( 1ST AT ,140000B) .NE. 0) GOTO 10 I 

I C I 

I C IF PORT IS NOT BUSY, CHECK TERMINAL ENABLED; ENABLE IF I 

I C NOT ALREADY ENABLED; OMIT THIS CODE IF TERMINAL ENABLE I 

I C IS CONTROLLED BY APPLICATION PROGRAM: I 

I IF (I AND (1ST AT, 1) .NE. 0) GOTO 20 i 

I CALL EXEC (3,2400B+LU) I 

I CALL EXEC (3 , 2000B+LU, 0) I 

I C I 

I C ISSUE LINE OPEN FOR 10 MINUTES: I 

I 20 CALL EXEC(3,3100B+LU,-6000) I 

I C I 

I C SCAN TO NEXT PORT: I 

I 10 CONTINUE I 

I END i 

I END$ I 

+ f 

Figure 2-3. Line Monitor Program Example 
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APPENDIX 



DEVICE EQUIPMENT TABLE 



The HP 91731A Multiplexer Subsystem requires a device Equipment Table 
(EQT) Entry for each port on the Multiplexer. The entry consists of 15 
words plus an extension of 11 words, or a total of 26 words. The EOT 
Entry is configured into the PTE Operating System at system generation 
time. 

During system operation, the logical and physical drivers get the port 
configuration instructions and pass information to each other through 
the EQT Entry for the port. Table A-l gives the function of each word 
in the Equipment Table Entry. 



Table A-l. Equipment Table Entry (part 1) 

+. . . — , — — ■ . __ : . „, , _. — , — + 

I EQT Word | Use I 

I Numbers I I 



i 1-10 I Described in the PTE Programmer's Reference Manual for I 

| I your system; word 5 is the status word. I 

I 11 | Used by DVS00 for temporary storage. I 

I 12 I Has the number of extension words requested at system | 

| | generation time. After initialization this word contains | 

I I the count for the logical driver time-out counter. I 

I 13 I Extension starting address. I 

I 14 | System time-out value; set at generation, or by system I 

I I TO command, or, when using LDVR5, by a control request I 

I I with a function code of 22 octal. I 

I 15 I System time-out counter, set by the physical driver I 

I I when either or both the physical or logical driver I 

I I needs a time-out. I 

I 16 I Count of the physical time-out counter. I 

I 17 I The address of the logical driver. Initially set to | 

I I the default TTY logical driver incorporated within I 

I | physical driver DVS00. A control EXEC call subf unction I 

I | 25B will set EQT17 to a new address. I 
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-DEVICE EQUIPMENT TABLE— 



Table A-l. Equipment Table Entry (part 2) 

Use 



EOT Word 
Number 



18 



19 



20 



21 



If, at generation time, the port assigned to this EQT 
is specified to schedule a program on interrupt, EQT18 
contains the address of the ID segment of that program, 
If not, E0T18 contains a negative one (-1). This 
specification is made in the Interrupt Table portion 
at generation time. 

Carriage return, line feed delays, and extended status 
are defined as follows: 



(Set) 

delays (stalls) 
delays (stalls) 



for 



for line 



Bits Meaning 

15 - 12 Value of character 

carriage return. 

11-8 Value of character 

feed. 

7 Fead/Write stall flag. 

6 Not used. 

5 Time-out caused by good completion 

4 1 = Read, 0 = Write Request. 

3 Modems enabled 

2 Backspace mode. 

1 Line Feed Delay mode. 

0 Carriage Return Delay mode. 

Stop bits for padding the output character = 43400B 
for no parity or even parity and = 43600B for odd 
parity. 



Line state and output character; 
as follows: 



the bits are defined 



Bits Meaning (Set) 

15 Logical time-out. 

14 Line error. 

13 Data error. 

12 Break condition. 

11-8 Not used. 

7-0 Next character to be output. 
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-DEVICE EQUIPMENT TABLE- 



Table A-l. Equipment Table Entry (part 3) 



EOT Word 
Number 




Use 




22 


Use defined as follows: 






Bits 


Meaning 






15 


Always 1. 






14 


Always 0. 






13 


0 = Down device on time-out.* 








1 = Do not down device on time-out.* 






12 


1 = Do not echo underscore on backspace. 








0 = Echo underscore on backspace. 






11-9 


Not used. 






8 


0 = 1 Stop bit. 








1=2 Stop bits. 






7 


0 = Echo off. 








1 = Echo on. 






5 & 4 


0 = Parity off 








1 = Parity odd. 








2 = Parity even. 






3-0 


Character size, not including stop bits 


and 






parity bit. 






* All errors cause a time-out 
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The states of the control board control signals 






for clear- to-send (CR) , and data-set-ready (CC) . 






Bits 


Meaning 






15-2 


Not used. 






1 


0 = CB down. 








1 = CB up. 






0 


0 = CC down. 








1 = CC up. 




24 


Contains 


the input port parameters, defined as 






follows : 








Bits 


Meaning 






15 


Always 1. 






14 


Always 0. 






13 


0 = Interrupts disabled. 








1 = Interrupts enabled. 






12 


0 = Echo disabled. 








1 = Echo enabled. 






11 


0 = Auto-speed not requested. 








1 = Auto-speed requested. 






10-8 


Total number of bits/character, (modulo 


8)-l, 






3 bits allocated for character size. 






7-0 


Port baud rate. 
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-DEVICE EQUIPMENT TABLE- 



Table A-l. Equipment Table Entry (part 4) 

Use 



EQT Word 
Number 



25 



26 



Contains the output port parameters. The definition 
of the bits is the same as for EQT24 with the excep- 
tion bit 14 which is a 1, and bit 12 for parity; see 
the definition of EQT word 20 for even-odd parity. 



Contains the line state, auto-speed condition, 
line open and close information, 



and 



14 



Bits 
15 

- 13 
12 
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Meaning 

Set when auto-speed detect is 
Not used. 

1 = Not operating with modems, 
0 - Operating with modems. 
Not used. 

Auto-speed completion: 
0 = Not completing auto-speed 



in progress. 



request. 



7 
1 



2 
0 



1 = Completing auto-speed request. 
Not used. 
Line State: 

0 = Line down (disconnected) 

1 = Line up, last driver operation: receive, 

2 = Line up, last driver operation: send. 
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